home *** CD-ROM | disk | FTP | other *** search
/ BCI NET / BCI NET Dec 94.iso / archives / programming / source / fbm12s.lha / Features < prev    next >
Text File  |  1994-07-18  |  6KB  |  159 lines
  1. **********************************************************************
  2. * Announcing Version 1.2 of the  "Fuzzy PixMap" (or FBM) image library *
  3. **********************************************************************
  4.  
  5.             *** new for 1.2 ***
  6.  
  7. The main addition is support for JPEG JFIF RGB and grayscale images
  8. using the independent JPEG Group's publically available library.
  9. Also new are a median filter, bitmap thining, improved PostScript printing, 
  10. and several bug fixes to Sun and Tiff format routines.
  11.  
  12.                *** Basic ***
  13.  
  14. This package allows manipulation and conversion of a variety of color
  15. and black-and-white image formats.
  16.  
  17. Philosophy
  18.  
  19.     Each program can read any of the understood formats, and
  20.     can write any of the understood formats that make sense for
  21.     the image data.
  22.  
  23.     Programs are designed around specific image operations (sizing,
  24.     scaling, retoning, halftoning, quantizing, etc.), rather than
  25.     simply converting from one format to another.  For example,
  26.     converting a 4bit color GIF file to a 1bit Sun rasterfile
  27.     takes the following operations:
  28.     
  29.         read GIF format
  30.         map color values to grayscale
  31.         adjust aspect ratio (1.2 --> 1.0)
  32.         scale image up to be visible (320x200 --> 640x480 or 1152x864)
  33.         optionally sharpen the image (edge enhancement)
  34.         optionally clean up "snow" in image (flip isolated pixels)
  35.         halftone (Blue noise, Floyd-Steinberg, Jarvis, Threshhold)
  36.         write Sun rasterfile format.
  37.  
  38.     So there equivalent pipeline of fbm routines would be:
  39.     
  40.     clr2gray < foo.gif | fbnorm | fbext [ args ] | fbhalf [args] > foo.1bit
  41.     
  42.     That way you have maximum control over the resulting image size
  43.     and quality.
  44.  
  45. Inputs the following file formats
  46.  
  47.   o GIF files        (1 to 8 bits, color or grayscale)
  48.   o JPEG JFIF files    (8 or 24 bits, color or grayscale)
  49.   o Sun rasterfiles    (1, 8, or 24 bits, color or grayscale)
  50.   o Utah RLE files    (from the Utah Raster Toolkit)
  51.   o Amiga IFF files    (except HAM mode)
  52.   o PCX files        (b&w and color)
  53.   o PBM bitmaps        (P1 format only)
  54.   o Face files        (CMU format for 1bit files by Bennet Yee)
  55.   o FBM files        (my own format)
  56.  
  57.     (automatically determines input format, and uncompresses
  58.      files compressed using 'compress')
  59.  
  60. Outputs the following formats
  61.  
  62.   o GIF files        (mapped color only)
  63.   o JPEG JFIF files    (8 or 24 bits, color or grayscale)
  64.   o Sun rasterfiles    (1, 8, or 24 bits, color or grayscale)
  65.   o Utah RLE files    (from the Utah Raster Toolkit)
  66.   o Amiga IFF files    (except HAM mode)
  67.   o PBM            (1bit files only)
  68.   o Face format        (1bit files only)
  69.   o FBM files        (my own format)
  70.  
  71. With input converters for
  72.  
  73.   o raw images          (like Amiga Digi-View files)
  74.   o Targa        By Ian MacPhedran
  75.   o PIC            By Ian MacPhedran
  76.   o QRT            By Butler Hines
  77.   o Amiga HAM        By C. Harald Koch
  78.   o Tiff format        By Michael Mauldin, using Sam Lefflers tifflib
  79.   o UseNet FaceSaver    By Dan Sahlin
  80.   o Microtek Postscript    By Gary Sherwin
  81.  
  82. With output converters for
  83.  
  84.   o PostScript        (1bit or 8bit grayscale, 24bit color)
  85.   o Diablo graphics    (1bit files only)
  86.   o Targa        By Ian MacPhedran
  87.   o Tiff Format        (using Sam Lefflers tifflib)
  88.  
  89. Operations
  90.  
  91.   o Extract rectangle (optionally resizing and changing aspect ratio)
  92.   o Change density and contrast (color and grayscale)
  93.   o Rotate  90, 180, or 270 degrees
  94.   o Quantize 24 bit RGB images to 8..256 colors
  95.         Modified Heckbert median cut
  96.   o Halftone grayscale using
  97.         Ulichney's Blue Noise dithering
  98.         Floyd-Steinberg dithering
  99.         Jarvis's Constrained averaging
  100.         Threshholding
  101.   o Edge Sharpening by Digitial Laplacian (color or grayscale)
  102.   o Median of 3x3 neighborhood filter
  103.   o Convert color to grayscale (or compute "gray" colormap
  104.         so grayscale images can be viewed on frame buffers)
  105.   o Compute histograms of grayscale images
  106.   o Smooth by averaging neighborhoods to convert 1bit -> 8bit or reduce size
  107.   o Clean stray pixels in bitmaps
  108.   o Do edge detection
  109.   o Reverse black and white (negative image)
  110.  
  111. Status
  112.  
  113.     Freely available for use, redistribution, incorporation into
  114.     other code.  Just don't remove the copyright notices or the
  115.     author(s) name(s) from any code.
  116.  
  117.     Written in C for BSD and Mach Unix Systems.
  118.     Tested on Vaxes, Sun Workstations, IBM RTs, Pyramids, and NeXTs.
  119.     
  120.     Self contained.  Does not require Sun include files or library
  121.     routines to manipulate Sun rasters.  Does require tifflib for
  122.     Tiff support, JPEG library for JFIF support, and Utah Raster
  123.     Toolkit for RLE support.
  124.  
  125. Availability
  126.  
  127.     Anonymous FTP, Use exactly these steps:
  128.     
  129.     % ftp nl.cs.cmu.edu        (or ftp 128.2.222.56)
  130.     User: anonymous
  131.     Password: your-name
  132.     ftp> binary
  133.     ftp> cd /usr/mlm/ftp
  134.     ftp> get fbm.tar.Z
  135.     ftp> get tiff.tar.Z
  136.     ftp> get jpeg.tar.Z
  137.     ftp> get utah.tar.Z
  138.     ftp> bye
  139.  
  140.     An earlier version was posted to UseNet and is available in the UUNET
  141.     archives.  This version will eventually be posted, after a period
  142.     of user testing.
  143.  
  144. Acknowledgements
  145.  
  146.     GIF read support written by David Koblas.
  147.     GIF write support written by David Rowley.
  148.     JPEG support by the Independent JPEG group
  149.     Utah RLE Support and Color Postscript support written by Paul Milazzo.
  150.     Targa support by Ian MacPhedran.
  151.     Some IFF code by Jerry Morrison and Steve Shaw of Electronic Arts.
  152.     Edge detection and pixel cleaning by Gary Sherwin and Michael Mauldin.
  153.  
  154. --
  155. Michael L. Mauldin (Fuzzy)        Carnegie Mellon University
  156. Research Computer Scientist        Center for Machine Translation
  157. E-mail: mlm+@NL.CS.CMU.EDU        5000 Forbes Avenue
  158. Phone: (412) 268-5293            Pittsburgh, PA  15213-3890
  159.